4D Doc Center : ch_Lire reference

4D Chart v13

ch_Lire reference


ch_Lire reference ( zone ; cible ) -> Résultat

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
cible	Entier long	Cible de la fonction -2 = Par défaut, -1 = Tout, 0 = Objets sélectionnés, >0 = ID de l’objet
Résultat	Entier long	Numéro de référence du ou des objet(s) désignés par cible

Description

La commande ch_Lire reference renvoie le numéro de référence du ou des objet(s) désigné(s) par cible et zone.

Un numéro de référence est un entier long associé à un objet, et il n’est pas obligatoirement unique. Les numéros de référence ne peuvent être manipulés que par méthode. C’est vous qui affectez un numéro de référence à un objet, mais c’est 4D Chart qui lui affecte son identifiant.

Si cible est égal à -2, ch_Lire reference renvoie le numéro de référence par défaut.
Si cible est égal à -1, ch_Lire reference renvoie le numéro de référence de tous les objets contenus dans le document. Si les numéros de référence des objets ne sont pas égaux, ch_Lire reference renvoie -32000.
Si cible est égal à 0, ch_Lire reference renvoie le numéro de référence des objets sélectionnés. Si les numéros de référence des objets ne sont pas égaux, ch_Lire reference renvoie -32000.
Si cible est supérieur à 0, il doit être égal à l’identifiant d’un objet spécifique et le numéro de référence de celui-ci est renvoyé. Si l’objet n’existe pas, ch_Lire reference renvoie -32000.

Exemple

L’exemple suivant est la méthode objet d’un bouton inscrit dans un formulaire contenant une zone 4D Chart. Lors de son exécution, la méthode objet assure qu’un seul objet est sélectionné, recherche l’enregistrement correspondant dans la table [Parts], et affiche sa description.

 CHERCHER([Parts];[Parts]RefNum=ch_Lire reference(Zone;0))

 ALERTE("Cet objet est un "+[Parts]Description)